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Executive  Summary 


The  Stockpile  Sizing  Module  (SSM)  is  a  modeling  tool  used  to  estimate  U.S.  shortfalls  of  strategic  and  critical  materials 
(S&CM)  during  a  national  emergency  scenario.  This  annotated  briefing  is  intended  to  train  a  new  user  on  the  basic  operation  of  SSM. 
It  is  designed  to  be  used  in  conjunction  with  a  training  version  of  SSM  available  on  compact  disc  (CD)  from  the  Institute  for  Defense 
Analyses  (IDA)  Control  and  Distribution  Department. 

SSM  Background 

Understanding  the  context  in  which  SSM  is  used  is  a  prerequisite  for  effective  operation.  SSM  is  a  subcomponent  of  a  larger 
modeling  and  decision  support  process,  the  Risk  Assessment  and  Mitigation  Framework  for  Strategic  Materials  (RAMF-SM).  RAMF- 
SM  is  designed  to  identify  potential  shortfalls  of  S&CM  in  a  national  emergency  scenario,  assess  market  responses  to  those  shortfalls, 
identify  risks  and  consequences  of  not  addressing  any  remaining  shortfalls,  and  design  and  compare  stockpiling  and  other  government 
strategies  to  mitigate  risks  stemming  from  these  shortfalls.  RAMF-SM  is  a  six-part  process,  and  SSM  is  used  in  Steps  2-C  and  2-D  of 
RAMF-SM  (see  the  figure  on  the  next  page).  Step  2-D  is  a  recent  addition  to  the  RAMF-SM  process  and  simulates  a  market  response 
to  the  initial  “Gross  Shortfalls.”  In  Step  2-D,  SSM  is  used  to  estimate  “Net  Shortfalls,”  shortfalls  that  remain  after  the  simulated  mar¬ 
ket  response  occurs.  Many  inputs  to  SSM  are  the  result  of  previous  modeling  and  simulation  efforts,  and  SSM  output  is  used  later  in 
RAMF-SM  to  assess  risks  and  identify  mitigation  options. 

SSM  Model  Logic 

SSM  inputs  are  organized  into  three  categories:  material  supplies,  supply  adjustments,  and  material  demands.  A  gross  material 
shortfall  occurs  if  (Supply  -  Adjustments)  <  Demand.  Material  supply  defines  how  much  of  each  material  is  available  from  domestic 
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SSM  in  Context 


and  foreign  sources.  This  information  is  provided  by  the  U.S.  Geological  Survey  (USGS)  and  other  relevant  sources.  Domestic  and 
foreign  supply  can  be  computed  on  the  basis  of  estimated  future  (i.e.,  during  the  scenario  period)  production,  estimated  future  produc¬ 
tion  capacity,  or  some  quantity  in  between.  SSM  combines  domestic  and  foreign  supply  information  to  compute  the  total  supply  of 
each  material  for  each  year  of  a  given  national  emergency  scenario,  which  typically  lasts  4  years,  in  accordance  with  Congressional 
guidance  in  the  Strategic  and  Critical  Materials  Stock  Piling  Act. 

SSM  uses  adjustment  factors  to  decrement  material  supply.  Adjustments  decreasing  supplies  available  to  the  United  States 
include  anti-American  political  sentiment  of  supplier  countries;  ability  degradation  of  supplier  countries  (e.g.,  poor  infrastructure); 
shipping  losses  due  to  enemy  action;  market  competition  from  other  countries  demanding  materials;  and  war  damage  to  material  pro¬ 
duction  facilities.  A  supply  political  reliability  code  designates  whether  material  supplies  from  a  particular  country  can  be  used  to  sat¬ 
isfy  U.S.  defense  and  civilian  needs,  only  civilian  needs,  or  not  at  all.  Much  of  this  information  is  classified  and  is  based  on 


IV 


Intelligence  Community  input  or  Defense  Planning  Scenarios  developed  by  the  Office  of  the  Under  Secretary  of  Defense  for  Policy 
(OUSD(P)).  SSM  applies  these  adjustments  to  derive  estimates  of  available  material  supplies. 

U.S.  material  demand  is  disaggregated  into  three  “tiers” — defense,  essential  civilian,  and  emergency  investment — for  each  mate¬ 
rial  and  each  year  of  the  scenario.  Material  demand  is  computed  in  previous  stages  (Steps  2 -A  and  2-B)  of  RAMF-SM  and  is  based  on 
U.S.  industrial  base  production  requirements  during  the  specified  emergency  scenario.  SSM  compares  (Supply  -  Adjustments)  to 
Demand,  and  identifies  shortfalls  by  year,  material,  and  tier  of  demand.  SSM  is  time-phased,  and  a  surplus  in  a  later  year  cannot  offset 
a  shortfall  in  an  earlier  year. 

SSM  Operation 

SSM  is  run  via  an  .exe  program.  This  executable  uses  control  input  files,  which  define  the  directories  and  data  input  files.  Some 
of  the  input  files  are  in  uncommon  fonnats,  but  most  are  tab-delimited  text  files  that  can  be  opened  and  edited  in  Excel  or  Notepad. 
SSM  is  designed  to  run  on  Windows  and  is  not  memory  or  run-time  intensive. 

The  first  control  input  file  is  characterized  by  the  extension  .sbf  and  specifies  the  SSM  output  directory,  default  case  directory, 
and  a  list  of  one  or  more  Case  Files  for  SSM  to  run.  The  Case  File  (recognizable  by  its  .cas  extension)  is  the  second  control  input  file 
and  performs  two  major  roles.  It  allows  the  user  to  specify  basic  scenario  parameters  (e.g.,  number  of  years  in  the  scenario)  and  the 
data  input  files  that  SSM  should  use  for  this  case. 

Data  input  files  include  lists  of  countries  and  materials  to  analyze,  basic  material  information,  U.S.  material  supply,  foreign  mate¬ 
rial  supply,  the  aforementioned  adjustment  factors  (each  of  which  has  its  own  file),  and  more.  SSM  uses  these  data  files  to  perform  the 
calculations  described  in  the  Model  Logic  section.  SSM  output  consists  of  a  variety  of  reports  concerning  material  supply,  demand, 
and  shortfalls. 

Many  of  these  files  can  contain  proprietary  and/or  classified  infonnation,  but  the  training  version  of  SSM  provided  with  this 
briefing  contains  only  notional  data,  allowing  for  the  operation  and  testing  of  SSM  in  an  unclassified  environment.  More  detailed 
infonnation  on  SSM  operation  can  be  found  in  IDA  Paper  P-2867  and  draft  Paper  P-4442. 

The  figure  on  the  next  page  presents  SSM  inputs  and  outputs  in  graphical  form. 
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1.  Introduction 


An  earlier  version  of  this  document  was  briefed  to  Defense  Logistics  Agency  (DLA)  representatives  at  the  Institute  for  Defense 
Analyses  (IDA)  facilities  on  July  9,  2014.  It  was  expanded  in  August  2014,  with  annotations  and  additional  infonnation. 
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IDA  SSM  Background 

The  Stockpile  Sizing  Module  (SSM)  is  the  culminating  modeling  component  in 
Step  2  of  the  Risk  Assessment  and  Mitigation  Framework  for  Strategic 
Materials  (RAMF-SM)  and  results  in  a  prediction  of  material  shortfalls  based 
upon  a  large  number  of  inputs  associated  with  the  supply  and  demand  for 
strategic  and  critical  materials  (S&CM). 

This  briefing  provides  an  overview  of  the  control  and  input  files  that  are 
necessary  to  run  SSM  and  is  only  intended  to  be  an  overview  since  detailed 
discussions  are  already  available  via  the  multi-volume  Institute  for  Defense 
Analyses  (IDA)  Paper  P-2867  and  upon  request. 

For  this  tutorial,  we  are  focusing  on  the  same  type  of  simulation  period  that  is 
used  for  the  National  Defense  Stockpile  (NDS)  Report  to  the  Congress.  The 
NDS  base  case  is  required  by  law  to  model  a  4-year  period  of  time  during 
which  the  first  year  is  defined  as  the  conflict  year  and  is  subsequently  followed 
by  three  post  conflict  recovery  years. 

The  provided  notional  files  are  set  up  to  mimic  this  type  of  scenario  with 
completely  notional  data  that  have  no  linkage  to  any  real-world  events. 
Flowever,  these  data  are  sufficiently  robust  to  test  and  evaluate  the  model's 
performance  and  the  relationships  between  its  inputs  and  outputs. 
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A  “real”  run  of  the  Stockpile  Sizing  Module  (SSM)  draws  upon  classified  data  and  must  be  done  on  a  classified  computer  sys¬ 
tem.  As  stated  previously,  all  of  the  data  in  this  briefing  are  completely  notional  and  are  intended  only  to  illustrate  the  model’s  logic 
and  to  allow  the  testing  and  evaluation  of  its  perfonnance. 

This  briefing  is  intended  to  be  used  in  conjunction  with  a  training  version  of  SSM.  This  training  version  differs  from  the  produc¬ 
tion  version  only  in  that  it  uses  notional  data.  The  training  version  of  SSM  is  stored  on  a  compact  disc  (CD)  associated  with  this 
briefing  and  can  be  obtained  from  the  IDA  Control  and  Distribution  Department.  It  can  be  run  on  an  unclassified  computer  system. 

SSM  is  a  fairly  simple  program  and  should  run  without  difficulty  on  a  Windows  operating  system.  Run  time  is  not  a  significant 
factor. 

IDA  Paper  P-2867  is  somewhat  out  of  date,  but  additional  and  up-to-date  information  on  SSM  is  available  upon  request. 
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2.  Conceptual  Overview 


This  section  provides  an  overview  of  the  logic  behind  SSM.  Individual  model  elements  are  examined  in  later  sections. 
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IDA  SSM  Inputs  and  How  They  Interact  with  Each  Other 

•  SSM  inputs  define  three  major  areas: 

-  Material  supply 

■  Domestic 

■  Foreign 

-  Material  demand 

-  Adjustments  to  supply  and  demand. 

•  Shortfall  occurs  if  (supply  -  adjustments)  <  demand. 
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SSM  inputs  are  organized  into  three  separate  categories: 

•  Supply  inputs.  These  inputs  specify  how  much  of  each  material  is  available  from  domestic  and  foreign  sources. 

•  Demand  inputs.  These  inputs  specify  the  materials  and  quantities  required  to  support  U.S.  defense,  essential  civilian,  and 
emergency  investment  needs. 

•  Supply  adjustments.  These  adjustments  decrement  the  share  of  supply  actually  available  to  the  United  States  to  account  for 
wartime  conditions  such  as  shipping  losses  and  unreliable  suppliers. 

A  shortfall  occurs  if  supply  minus  adjustments  is  less  than  demand  for  a  particular  material  in  a  particular  year. 

SSM  also  requires  basic  information  input  files,  which  specify  factors  such  as  the  materials  and  countries  to  be  studied,  the 
length  of  the  scenario,  and  so  forth. 
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IDA  Does  Supply  with  Adjustments  Equal  Demand? 

SSM  Calculations 

SSM  Calculations 

SSM  Calculations 

Add  U.S.  and  foreign 
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each  material  by  year. 

Apply  decrements  to  supply.  Results  in 
SSM  knowing  how  much  of  each 
material  for  each  country  for  each  year 
is  available  for  what  uses. 
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This  slide  shows  what  specific  input  files  perform  what  role  in  the  shortfall  calculation  process. 
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IDA  Input  File  Changes  and  Shortfalls 

All  of  the  following  are  generally  true  ceteris  paribus  (i.e. ,  all  other 
things  being  equal  or  held  constant): 

•  Increasing  supply  decreases  existing  shortfalls 

-  Converse:  Decreasing  supply  increases  existing  shortfalls 

•  Increasing  supply  decrements  increases  existing  shortfalls 

-  Converse:  Decreasing  supply  decrements  decreases  existing  shortfalls 

•  Increasing  demand  increases  existing  shortfalls 

-  Converse:  Decreasing  demand  decreases  existing  shortfalls 
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It  is  helpful  to  understand  how  altering  input  file  values  changes  computed  shortfalls.  All  of  the  following  are  true  ceteris  paribus 
(i.e.,  all  other  things  being  equal  or  held  constant): 

•  Increasing  U.S.  domestic  supplies  decreases  existing  shortfalls,  and  decreasing  U.S.  domestic  supplies  increases  existing 
shortfalls.  Increasing  available  foreign  supply  decreases  existing  shortfalls,  and  decreasing  available  foreign  supply  increases 
existing  shortfalls.1 

•  Available  foreign  supply  can  decrease  because  of  increased  shipping  losses,  decreased  ability  scores  (i.e.,  Supply  Political 
Reliability  Factors)  for  supplying  countries,  decreased  willingness  scores  (i.e.,  Supply  Pro-U.S.  Factors)  for  supplying  coun¬ 
tries,  changes  in  the  Supply  Political  Reliability  Codes  assigned  to  supplying  countries,  decreased  U.S.  Market  Share,  and 
increased  Supply  Factor  War  Damage. 

•  Available  foreign  supply  can  increase  because  of  decreased  shipping  losses,  increased  ability  scores  (i.e.,  Supply  Political 
Reliability  Factors)  for  supplying  countries,  increased  willingness  scores  (i.e.,  Supply  Pro-U.S.  Factors  for  supplying  coun¬ 
tries,  changes  in  the  Supply  Political  Reliability  Codes  assigned  to  supplying  countries,  increased  U.S.  Market  Share,  and 
decreased  Supply  Factor  War  Damage. 

•  Increasing  U.S.  demand  for  materials  increases  existing  shortfalls,  and  decreasing  demand  for  materials  decreases  existing 
shortfalls. 

•  U.S.  material  demand  can  increase  because  of  many  things,  including  increased  civilian  economic  production,  increased 
Future  Years  Defense  Plan  (FYDP)  defense  spending,  increased  conflict  attrition/expenditure,  increased  emergency  invest¬ 
ment,  and  increased  homeland  damage  and  reconstruction. 


Strictly  speaking,  it  is  possible  that  increased  U.S.  domestic  supplies  would  not  decrease  shortfalls  and  that  these  shortfalls  would  remain  the  same.  For 
example,  this  situation  could  occur  if  the  increase  in  U.S.  domestic  supplies  was  only  for  materials  that  were  not  in  shortfall.  Similar  arguments  can  be  made 
for  most  of  the  points  listed  here.  They  still  are  useful,  however,  to  illustrate  the  general  manner  in  which  input  fdes  affect  shortfall  results. 
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3.  Basic  Input  Files 


SSM  requires  several  input  files  that  specify  basic  parameters  of  the  scenario.  These  inputs  include  the  following: 

•  Which  files  and  directories  should  be  used, 

•  What  scenario  assumptions  should  be  made  (e.g.,  the  number  of  years  in  the  scenario), 

•  Which  countries  should  be  considered,  and 

•  Which  materials  should  be  considered. 

This  section  addresses  these  input  files. 
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IDA  SSM  Operation 

•  SSM  defaults  for  the  following  items  are  specified  in  files  with  the 
*.sbf  extension  (SSM  asks  for  this  filename  at  run  time): 

-  Modeling  outputs  directory, 

-  Case  file(s)  directory, 

-  Runs  to  be  performed,  which  are  specified  as  case  filenames  that  must 
be  located  in  the  case  file  directory,  and 

-  Database  directory,  where  the  input  files  are  stored. 

•  SSM  outputs  are  tab-delimited  text  files  that  are  stored  in  separate 
folders  for  each  case  file  in  the  modeling  outputs  directory. 

•  The  database  subdirectory  of  the  main  directory  must  have  the 
name  database.  It  must  be  a  subdirectory  of  the  main  directory. 
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SSM  input  and  output  files  use  a  variety  of  uncommon  file  extensions  (.cas,  .sbf,  and  so  forth).  Although  a  user’s  computer  can 
give  a  message  indicating  that  the  file  type  is  not  recognized,  all  SSM  files  can  be  opened  and  edited  with  either  a  text  editor  (e.g., 
NotePad)  or  a  spreadsheet  program  (e.g.,  Excel).  Microsoft  Excel  is  the  recommended  file  editor  and  reader  for  SSM  input  and  output 
files  since  most  files  are  “tab-delimited  text  files.”  Notepad  can  also  be  used  since  it  also  handles  most  text  file  fonnats.  However, 
Microsoft  Excel  has  the  advantage  of  showing  tab  spacing  via  columns,  which  can  be  of  great  assistance  when  entering  and  editing 
data.  Most  SSM  input  formats  require  strict  adherence  to  format  rules. 


18 


IDA  Specifying  the  SSM  Runtime  Defaults 

SSM  defaults  are  specified  via  a  user  input  file  with  a  .sbf  file  extension. 
In  the  screenshot  below,  we  have  specified 

•  The  SSM  output  directory, 

•  The  SSM  case  file  directory,  and 

•  The  name  of  the  case  file  that  we  wish  to  execute. 
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This  slide  addresses  specifying  the  SSM  runtime  defaults. 

An  advanced  analyst/modeler  can  use  the  .sbf  file  to  make  multiple  SSM  runs  in  a  single  batch  process,  but  the  details  are 
beyond  the  scope  of  this  briefing,  which  focuses  on  the  basics  of  SSM  operation. 
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IDA  SSM  Case  File 


The  Case  File  specifies  parameters  for  a  particular  SSM  run.  In  other  words,  it 
defines  the  basic  conditions  and  assumptions  under  which  a  particular  SSM  run 
should  operate. 

The  Case  File  is  a  .cas  file  and  is  best  opened  in  Notepad.  A  unique  filename 
(e.g.,  tryl  1 18. cas)  is  often  used  to  emphasize  that  each  specific  Case  File  is  tied 
to  a  specific  run  of  SSM. 

The  Case  File  is  large  and  will  be  examined  in  sections,  each  of  which 
corresponds  to  a  particular  set  of  parameters  specified  in  the  following  Case  File: 


trylll8.cas  -  Notepad  {  1=3 

P 

File  Edit  Format  View  Help 

|[notes] , , , , , 

case  testlll8,19-Jun,2014, , , 

This  is  s  sample  SSM  run  to  illustrate  the  theoretical  foundations  and,,,,, 
practical  implementation  of  the  SSM  model.  All  countries  and  materials,,,,, 

in  the  sample  input  files  are  fictional.  The  data  associated  with  these . 

countries  and  materials  was  generated  randomly.  ,,,,, 
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The  Case  File  allows  the  user  to  control  almost  all  SSM  inputs.  Except  for  the  notes  section  and  the  header  in  brackets,  the  lines 
in  the  Case  File  are  delimited.  The  SSM  can  read  either  tab  delimiting  or  comma  delimiting.  The  Case  File  can  be  edited  in  Excel  as  a 
delimited  text  file  and  then  resaved.  A  comma-delimited  file  can  be  edited  in  Notepad,  but  the  comma  is  a  delimiter  character  and 
should  be  treated  as  such. 
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IDA  Case  File:  Scenario  Parameters 

The  Scenario  Parameters  section  of  the  Case  File  allows  the  user  to  specify 
the  following: 

•  Total  years.  Number  of  years  in  the  scenario. 

•  Starting  year.  The  year  in  which  the  scenario  begins. 

•  Warning  years.  Years  in  the  scenario  before  the  war  starts  in  which  the  country 
can  take  action  to  support  the  war  effort. 

•  Shortfall  years.  Whether  shortfalls  in  warning  years  (if  extant)  should  be  included 
in  total  shortfall  calculations. 
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The  input  value  for  “Total  Years”  is  almost  always  4,  in  line  with  Congressional  guidance  in  the  Strategic  and  Critical  Materials 
Stockpiling  Act  (“...  The  stockpile  requirements  shall  be  based  on  those  strategic  and  critical  materials  [S&CM]  necessary  for  the 
United  States  to  replenish  or  replace,  within  three  years  of  the  end  of  the  [year-long]  military  conflict  scenario  . . 

The  input  value  for  “Starting  Year”  depends  on  the  National  Defense  Stockpile  (NDS)  Requirements  Report  cycle  for  which  the 
analysis  is  being  conducted. 

The  input  values  for  “Warning  Years”  and  “Shortfall  Years”  often  are  0. 
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IDA  Case  File:  Adjustment  Parameters 

Adjustment  Parameters  allow  the  user  to  adjust  SSM  parameters  by  some  fixed 
factor  for  a  particular  year. 

For  example,  in  the  file  below,  modifying  military_demands  to  2,  0.5,  1,  1  would 
double  military  material  demand  in  the  first  year  of  the  scenario,  halve  it  in  the 
second  year,  and  leave  it  at  its  original  base  value  in  the  third  and  fourth  years. 

The  meaning  of  these  parameters  is  explained  later.  For  now,  it  is  most 
important  to  grasp  that  the  Case  File  allows  adjustment  of  the  parameters. 


trylll8.cas  -  Notepad 
File  Edit  Format  View  Help 

f  f  f  »  f 

[adjustment  parameters] , , , , , 
0 , year_of _scenar i o , 1 , 2 , 3 , 4 
1 , mi  1 i t ary_demands , 1 , 1 , 1 , 1 
2 , i nvestment_demands , 1 , 1 , 1 , 1 

3 ,  ci vi 1 i an_demands , 1 , 1 , 1 , 1 

4 ,  cur  ent_f aci 1 i ti es , 1 , 1 , 1 , 1 

5,  restarts, 1,1, 1,1 

6,  new_f aci 11 ties ,1,1, 1,1 

7 ,  assured_supp1y ,1 ,1 ,1 ,1 

8, re1iab]e_supply,l,l,l,l 
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The  first  entry  in  this  example  fil q,  year _of_scenario,  is  declaring  the  format  for  subsequent  entries.  It  ensures  that  SSM  “knows” 
an  entry  of  four  comma-separated  values  is  referring  to  the  4  years  of  the  scenario  (e.g.,  2,  0.5,  1,  1  means  an  adjustment  of  2  for  the 
first  year,  0.5  for  the  second,  1  for  the  third,  and  1  for  the  fourth).  This  convention  is  used  in  many  time-phased  SSM  parameter  inputs. 

Values  must  be  between  zero  and  two.  A  value  of  one  means  no  adjustment  will  be  made  (e.g.,  it  will  be  multiplied  by  one  and, 
hence,  unchanged). 

These  options  are  rarely  used,  and  a  new  user  is  advised  to  leave  them  set  at  1 . 
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IDA  Case  File:  Default  Parameters 

Default  Parameters  specify  what  values  SSM  should  use  in  case  of  missing 
data. 

For  example,  a  separate  input  file  for  Shipping  Losses  specifies  what 
percentage  of  material  supplies  from  a  particular  country  is  deemed  unavailable 
to  the  United  States  during  the  conflict  scenario  because  of  enemy  attacks 
against  shipping.  Each  country  has  its  own  entry  for  each  year.  The  Case  File 
in  the  screenshot  below  specifies  that  if  data  for  a  particular  country  in  the 
Shipping  Losses  input  file  are  missing,  SSM  should  use  1  (which  corresponds 
to  no  shipping  lost)  as  the  default  value. 
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The  Default  Parameters  entered  here  do  not  override  data  inputs  entered  elsewhere.  All  of  the  parameters  listed  here  have  sepa¬ 
rate  input  files.  SSM  will  use  the  values  entered  in  those  files  unless  data  for  a  particular  country  or  year  are  missing,  in  which  case 
SSM  reverts  to  the  Default  Parameters  specified  in  the  Case  File. 

The  exact  meaning  of  these  values  is  explained  later  in  this  document.  For  now,  it  is  important  to  understand  that  the  Case  File 
allows  one  to  use  Default  Parameters  to  deal  with  missing  or  incomplete  data. 
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IDA  Case  File:  Default  Supply  Parameters  and  Concentration  Rule 

Default  Supply  Parameters  and  Concentration  Rule  allow  the  user  to  modify 
details  of  the  algorithms  used  in  various  SSM  computations.  However,  they  are 
beyond  the  scope  of  this  beginner  tutorial  and  will  not  be  examined. 
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Explanations  of  the  various  supply  calculation  methods  and  concentration  rules  can  be  found  in  IDA  Paper  P-2867. 
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IDA  Case  File:  Files 

The  Files  section  specifies  what  data  input  files  SSM  should  use.  For  example,  in 
the  file  in  the  screenshot  below,  the  Foreign_Demand_for_Material,  smpfrdmd, 
smpfrdmd-foreign  demanders  sample  file  entry  specifies  that  SSM  should  use  a 
file  called  smpfrdmd  that  contains  sample  information  on  foreign  demand  by 
material.  These  files  must  be  in  the  database  subdirectory  of  the  main  directory, 
as  declared  in  the  .sbf  file  (see  slide  8). 

This  information  corresponds  with  a  separate  configuration  file,  longname.ini. 
(see  slide  16). 


trylll8.cas  -  Notepad 


File  Edit  Format  View  Help 


[flies] , , , , , 

1, Foreign_Demand_for_Material , smpfrdmd, smpfrdmd — foreign  demanders  sample  file,, 

2 , Demana_Factor_war_Damage,smpwardm,smpwardm — demand  war  factor  damage  sample  file,, 

3 , Demand_Factor_political_Reliability, smppol dm.smppoldm — demand  factor  political  reliability  sample  file,, 

4 , GDP_of_Demandi ng_Countri es , smpgdpdm, smpgdpdm — qdp  of  demanding  countries  sample  file,, 

5 , Foreign_supply_of -Material ,smpfrsup,smpfrsup — foreign  supply  of  materials  sample  file,, 

6 ,  supply_Factor_war_Damage , smpwarsp , smpwarsp--supply  factor  war  damage  sample  file,, 

7,  supply_Pol iti cal_Rel i abi lity_Codes .smpcodsp, smpcodsp — supply  political  reliability  codes  sample  file,, 

8 ,  supply_Pol iti cal_Rel i abi 1 ity_F actors , smppol sp , smppol sp — supply  political  reliability  factors  sample  file,, 
9,Supply_Shipping_Loss_Factors,smpsslsp,smpsslsp — supply  shipping  loss  factors  sample  file,, 

10, us_Requi rements .smpusreq .smpussreq — us  requirements  sample  file,, 

11, US_Supply,smpussup,smpussup — us  supply  sample  file,, 

12  ,Basi  conformation,  smpbasic.smpbasic — basic  information  sample  file,, 

13 , u. s. _Market_shares , smpmrkts .smpmrkts — us  market  shares  sample  file,, 

15 ,Pro_us_Factors .smpprous .smpprous — pro  us  factors  sample  file,, 
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The  meaning  and  use  of  these  files  are  examined  later  in  this  document. 

The  lines  in  the  screenshot  in  this  slide  are  comma  delimited  and  contain  the  file  type  number  (hard  coded),  the  file  type  name 
(hard  coded),  the  short  filename  (eight  characters  max),  and  the  long  filename. 
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IDA  SSM  File  longname.ini 

SSM  Control  File  longname.ini  establishes  a  file  type  for  the  SSM  input  files. 
The  input  file  types  run  numerically  from  1  to  15,  as  shown  in  the  screenshot 
below.  More  detail  is  contained  in  IDA  Paper  P-2867  and  the  RAMF-SM  Step  2 
Overview.  The  user  does  not  have  to  deal  with  this  file,  since  it  is  automatically 
updated  by  the  SSM  program. 
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In  the  screenshot  in  this  slide,  note  that  there  is  no  file  14.  It  is  an  optional  file  beyond  the  scope  of  this  beginner  tutorial.  There  is 
also  an  optional  file  16  (not  pictured)  that  is  used  with  the  “Expanded  Market  Share”  option,  as  explained  on  Slide  18. 
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IDA  Case  File:  Materials 

The  Case  File  allows  the  user  to  specify  what  materials  to  study. 

trylll8.cas  -  Notepad 
File  Edit  Format  View  Help 

[materials]  , , , , , 

Materi  al_l , 

Mater  ial_2 , 

Mater ial_3 , 

Materi  al_4 , 

Material_5 , 

Materi  al_6, 

Materi  al_7, 

Materi  al_8, 

Materi  al_9, 

Materi  al_10, 

This  file  corresponds  with  a  separate  input  file,  material.txt.  A  screenshot  of  the 
test  data  used  for  material.txt  is  shown  below.  The  material.txt  file  must  reside 
in  the  database  subdirectory. 
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The  sponsor  typically  judges  what  S&CM  should  be  included.  The  list  of  materials  varies  between  different  NDS  Requirement 
Report  cycles.  In  the  SSM,  information  is  correctly  matched  either  by  material  name  or  country  name.  To  facilitate  this  matching  and 
reduce  errors,  all  entries  must  match  entries  in  master  lists.  The  master  material  list  is  in  the  material.txt  file.  When  a  case  is  run,  the 
SSM  checks  all  input  files  against  the  master  material  list.  If  there  are  any  material  names  that  do  not  match  entries  in  the  master  list, 
an  error  message  will  be  generated.  A  similar  process  is  used  to  verify  countries  against  a  master  list,  as  covered  on  pages  38  and  39. 
Note  that  the  list  of  materials  in  a  Case  File  has  to  be  a  subset  of  the  materials  in  material.txt,  but  not  all  the  materials  listed  in 
material.txt  need  be  treated  in  a  given  case. 
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IDA  Case  File:  Options 

Lastly,  the  Case  File  contains  a  number  of  miscellaneous  options: 

•  Cap  Imports  allows  the  user  to  cap  imports  at  some  percentage  of  peacetime 
levels. 

•  Cap  Peacetime  Percent  allows  the  user  to  define  this  percentage. 

•  Delete  Old  Output  will  delete  all  old  output  files  that  have  been  generated  for  the 
case  or  cases  to  be  run. 

•  GDP  Ratio  Cutoff  and  Expanded  Market  Share  Percent  are  explained  in  the 
notes  to  this  slide. 
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GDP  Ratio  Cutoff  applies  to  an  algorithm  used  in  SSM  to  model  the  delayed  supply  of  materials.  Some  countries  are  assumed  to 
restrict  their  supply  of  S&CM  to  the  United  States  because  of  anti-American  political  sentiment  (see  Slide  27).  Even  if  these  countries 
do  not  intend  to  export  to  the  United  States,  the  United  States  likely  can  obtain  materials  once  these  materials  have  entered  the  world 
market  by  purchasing  through  intermediaries.  However,  purchasing  through  intermediaries  is  more  circuitous  and  time  consuming 
than  direct  purchase.  As  such,  supplies  are  assumed  to  be  available  to  the  United  States  after  a  time  delay.  This  delay  is  computed  as  a 
function  of  the  ratio  of  the  supplier  country’s  entry  in  the  GDP  input  file  to  the  U.S.  entry,  with  a  higher  ratio  resulting  in  a  longer 
delay. 

Expanded  Market  Share  Percent  refers  to  an  SSM  feature  in  which  the  United  States  can  obtain  not  just  its  regular  share  of  for¬ 
eign  supply,  but  also  an  expanded  share  of  previously-unused  foreign  production  capacity. 
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IDA  Specifying  the  Countries  of  Interest 

All  countries  of  interest  are  input  via  the  file  country.txt. 

The  screenshot  below  shows  an  example  of  the  file  that  will  be  used  for  training 
purposes. 
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The  country  input  file  must  include  an  entry  for  every  country  that  is  a  supplier  (source  for)  or  demander  (user  of)  the  strategic 
materials  that  will  be  analyzed.  This  list  is  usually  a  function  of  the  materials  being  studied  and  the  countries  whose  industrial  bases 
consume  these  materials.  SSM  checks  the  country  names  in  the  data  files  against  the  entries  in  country.txt  and  notes  any  missing  coun¬ 
tries  (including  misspelled  country  names). 
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IDA  Input  of  Material-Specific  Information 

Material-specific  information  is  input  via  file  smpbasic.txt,  as  follows: 

•  Field  one  contains  the  short  name  for  the  material  used  in  the  program. 

•  Field  two  contains  the  descriptive  name  of  the  material  (used  in  output  reports). 

•  Field  three  is  the  units  used  for  the  material. 

•  Field  four  is  the  price  per  unit. 

•  Field  five  contains  the  current  statutory  goal  (not  typically  used  and  set  to  0). 

•  Field  six  contains  the  cost  of  the  statutory  goal  calculated  with  the  price  per  unit  in 
field  four  (also  typically  not  used  and  set  to  0). 


_j]  smpbasic  -  Notepad 

1  =  II  0  II  S3 

File  Edit  Format  View  Help 

MATERIAL 

LONG_NAME 

TARGET_UNITS 

DLA_PRICE 

GOAL 

Material_l 

Material 

1 

MT 

1000 

0 

0 

Material_2 

Material 

2 

MT 

Oxi  de 

2000 

0 

0 

Material_3 

Material 

3 

kg 

3000 

0 

0 

Material _4 

Material 

4 

kg 

4000 

0 

0 

Material_5 

Material 

5 

kg 

5000 

0 

0 

Material_6 

Material 

6 

MT 

6000 

0 

0 

Material  _7 

Material 

7 

ST 

7000 

0 

0 

Material  _8 

Material 

8 

oz 

8000 

0 

0 

Material_9 

Material 

9 

MT 

9000 

0 

0 

Material_10 

Material 

10 

MT 

Oxi  de 

10000 

0 

0 
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Materials  often  have  informal  short  names  but  also  have  more  formal  long  names.  SSM  permits  the  use  of  both  names  and  allows 
the  user  to  input  this  information  into  the  model.  Similarly,  materials  are  sold  in  differing  units  on  the  world  market.  As  such,  SSM 
uses  the  material  units  that  are  most  commonly  used  for  a  given  material  (i.e.,  TARGETUNITS).  To  understand  the  material  costs 
involved,  the  price  that  DLA  pays  for  a  given  unit  of  a  specific  material  is  entered  for  each  material  in  the  DLAPRICE  column.  If 
some  statutory  goal  has  been  established  for  a  specific  material,  the  goal  is  input  in  the  required  units,  and  the  cost  of  that  goal  is 
entered.  Currently,  most  runs  of  SSM  assume  that  no  statutory  goals  are  in  effect,  and  the  values  and  costs  are  therefore  set  to  zero. 
The  amount  of  statutory  goal,  if  any,  does  not  affect  the  material  shortfall  computation. 
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IDA 


SUPPLY  INPUT  FILES 
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4.  Supply  Input  Files 


To  compute  available  supplies,  SSM  must  first  take  into  account  base  foreign  and  U.S.  supplies. 
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IDA  Inputs  for  U.S.  Material  Supplies 

The  file  smpussup.txt  contains  U.S.  supply  figures  for  current  facilities,  restarts, 
and  new  starts  for  each  year  for  each  material. 

All  figures  are  in  the  units  specified  in  the  basic  information  file.  Note  that  the 
years  in  the  first  row  are  repeated  three  times.  The  first  set  is  for  current 
facilities,  the  second  set  is  for  restarts,  and  the  third  set  is  for  new  starts. 

This  information  is  used  in  the  supply  calculations.  The  materials  are  listed  in 
the  first  field  in  alphabetical  order.  The  subsequent  fields  show  U.S.  supply  by 
year  and  facility  type  (current,  restart,  or  new). 


MATERIAL 

2010 

2011 

2012 

2013 

2014 

2015 

2010 

2011 

2012 

2013 

2014 

2015 

2010 

2011 

2012 

2013 

2014 

2015 

Materials. 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Materials 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material_3 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Mater ial_4 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Materials 

1(M) 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material  _(j 

1(M) 

100 

100 

KM) 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material_7 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material  8 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material  9 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 

Material  10 

100 

100 

100 

100 

100 

100 

50 

50 

50 

50 

50 

50 

20 

20 

20 

20 

20 

20 
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U.S.  supply  refers  to  domestic  supplies  of  each  material  for  each  year  of  the  scenario.  This  information  is  supplied  by  the  U.S. 
Geological  Survey  (USGS)  and  subject  matter  experts  (SMEs). 

Domestic  supply  consists  of  three  components: 

•  Current  U.S.  production  capacity, 

•  Supply  restarts  (i.e.,  the  amount  available  if  currently  closed  facilities  were  restarted),  and 

•  New  supply  starts  (i.e.,  the  amount  available  if  new  production  facilities  were  brought  online). 

Current  U.S.  production  capacity  is  considered  to  encompass  capacity  clearly  expected  to  be  in  place  in  the  scenario  period. 
Restarts  and  new  starts  (often  referred  to  as  “concerted  programs”)  often  are  not  included  in  the  Department  of  Defense  (DOD) 
stockpile  analysis,  even  though  the  sample  database  does  include  them.  They  represent  facilities  that  are  not  expected  to  be  in 
production  during  the  scenario  period  and  would  require  considerable  special  investment  to  be  brought  online. 
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IDA  Inputs  of  Foreign  Material  Supply 

Foreign  material  supply  is  input  via  file  smpfrsup.txt.  A  screenshot  is  shown 
below. 

smpfrsup  -  Notepad  |  a  |f  0  ||  S3  | 


File  Edit  Format  View  Help 


MATERIAL 

COUNTRY  2010 

2011 

2012 

2013 

2014 

2015 

Material  _1 

Country  1 

lOO 

lOO 

100 

lOO 

lOO 

lOO 

Mater ia"l_l 

Country  2 

1000 

lOOO 

1000 

lOOO 

1000 

lOOO 

Ma  t  e  r  i  a  1  _1 

country  3 

100 

100 

100 

lOO 

100 

lOO 

Materia 1_1 

country  4 

10 

10 

10 

lO 

lO 

10 

Material_l 

country  5 

lOO 

lOO 

100 

lOO 

lOO 

lOO 

Material _1 

Country  G 

1000 

1000 

1000 

1000 

1000 

1000 

Material _2 

Country  2 

2000 

2000 

2000 

2000 

2000 

2000 

Mater ial_2 

Country  3 

200 

200 

200 

200 

200 

200 

Ma  t  e  r  i  a  1  _2 

Country  4 

20 

20 

20 

20 

20 

20 

Materia 1_2 

country  5 

200 

200 

200 

200 

200 

200 

Material  J2 

Country  G 

2000 

2000 

2000 

2000 

2000 

2000 

Material _2 

Country  7 

200 

200 

200 

200 

200 

200 

Material _3 

Country  2 

3000 

3000 

3000 

3000 

3000 

3000 

Mater ial_3 

Country  3 

300 

300 

300 

300 

300 

300 

Mater ial_3 

Country  4 

30 

30 

30 

30 

30 

30 

Materia 1_3 

country  5 

300 

300 

300 

300 

300 

300 

Material  3 

Country  G 

3000 

3000 

3000 

3000 

3000 

3000 

Material  4 

Country  2 

4000 

4000 

4000 

4000 

4000 

4000 

Mater ial_4 

Country  3 

400 

400 

400 

400 

400 

400 

Ma  t  e  r  i  a  1  _4 

Country  4 

40 

40 

40 

40 

40 

40 

Ma  t  e  r  i  a  1  _4 

Country  5 

400 

400 

400 

400 

400 

400 

Materia 1_4 

country  6 

4000 

4000 

4000 

4000 

4000 

4000 

Material  4 

Country  7 

400 

400 

400 

400 

400 

400 

Material  4 

country  8 
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Foreign  material  supply  can  be  calculated  on  the  basis  of  current  production  or  total  capacity.  USGS  normally  provides  this  infor¬ 
mation.  Note  that  material  supply  is  broken  down  by  material,  country,  and  year.  The  actual  U.S.  share  of  foreign  material  supply  will 
almost  certainly  be  smaller  than  the  amount  input  here  since  SSM  applies  decrements  to  these  amounts  to  account  for  a  wide  variety  of 
factors  (e.g.,  political  reliability,  shipping  losses,  and  so  forth),  as  covered  in  the  next  section. 
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SUPPLY  DECREMENT  INPUT  FILES 
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5.  Supply  Decrement  Input  Files 


SSM  now  must  decrement  the  aforementioned  base  supplies  to  account  for  wartime  conditions  that  could  decrease  the  share  of 
supplies  actually  available  to  the  United  States.  Decrement  factors  include  supply  political  reliability  codes,  political  reliability  factors, 
pro-U.S.  factors,  supply  war  damage  factors,  country  shipping  losses,  and  U.S.  market  share.  Each  of  these  concepts  is  entered  into 
SSM  via  an  input  file.  This  section  examines  the  use  and  provenance  of  decrement-related  input  files. 
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IDA  Input  of  Supply  Political  Reliability  Codes 

SSM  uses  political  reliability  codes  to  determine  whether  supplier  countries  are 
assured,  reliable,  or  unreliable  suppliers  of  the  materials  that  they  supply. 

Material  supplies  from  assured  countries  can  be  used  to  satisfy  U.S.  civilian, 
defense,  and  emergency  investment  demands.  Material  supplies  from  reliable 
countries  can  be  used  to  satisfy  U.S.  civilian  demands  (but  not  defense  or 
emergency  investment).  Material  supplies  from  unreliable  countries  cannot  be 
used  to  satisfy  any  U.S.  demands. 

Political  reliability  codes  are  input  via  file  smpcodsp.txt.  A  screenshot  of  a 
typical  file  is  shown  below.  Note  that  the  file  contains  the  country  name,  the 
year,  and  a  code  letter  A,  U,  or  R  to  designate  their  reliability  in  a  given  year. 
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The  code  names  and  letters  have  specialized  meanings.  Assured  (A)  countries’  material  supplies  can  be  used  to  meet  civilian, 
defense,  and  emergency  investment  material  demands.  Reliable  (R)  countries’  material  supplies  can  be  used  to  meet  civilian  demands 
only.  Unreliable  (U)  countries  cannot  have  their  material  supplies  used  to  meet  any  demands  (i.e.,  the  computer  program  ignores  input 
supply  values  and  sets  the  usable  supply  to  zero). 

Note  that  values  for  a  particular  country  can  vary  by  year  (i.e.,  a  country  that  is  assured  during  one  year  can  be  coded  as  reliable 
or  unreliable  in  a  different  year  and  vice  versa).  Note  also  that  political  reliability  codes  are  distinct  from  political  reliability  factors, 
which  are  covered  on  the  next  slide.  The  former  specifies  what  tiers  of  demand  can  be  satisfied  by  supply  from  a  particular  country, 
while  the  latter  specifies  what  percentage  of  supply  from  a  particular  country  is  likely  to  be  available  for  consumption. 
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IDA  Input  of  Country  Political  Reliability  Factors 

File  smppolsp.txt  contains  the  political  reliability  factors  for  each  country  and 
the  year  of  the  scenario.  In  this  file,  0.9  indicates  that  10%  of  the  country’s 
supply  is  assumed  to  be  unavailable. 

The  country  is  the  first  field  and  must  be  in  alphabetical  order.  The  political 
reliability  factors  are  in  the  subsequent  columns,  which  represent  each  year.  In 
practice,  these  factors  are  usually  obtained  through  subject  matter  experts 
(SMEs). 
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Reliability  was  formerly  represented  as  a  single  factor.  It  has  since  been  disaggregated  into  ability  (i.e.,  to  what  degree  could  poor 
infrastructure,  labor  unrest,  and  so  forth  prevent  an  otherwise  willing  country  from  supplying  the  United  States)  and  willingness  (i.e., 
to  what  degree  could  anti-American  sentiment  lead  an  otherwise  able  country  to  reduce  supplies  to  the  United  States).  The  Supply 
Political  Reliability  Factors  input  file  defines  the  ability  of  a  country  to  produce  to  its  stated  industrial  capability  or  capacity  in  a  given 
year.  Note  that  these  values  can  change  from  year  to  year  to  reflect  ongoing  conditions  within  a  given  country.  The  factor  value,  which 
must  be  between  zero  and  one,  represents  the  fraction  of  its  supply  that  the  country  is  able  to  produce  in  the  given  year. 
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IDA  Input  of  Pro-U.S.  Sentiment 

Foreign  sentiment  toward  the  United  States  is  input  into  SSM  via  the  file 
smpprous.txt.  The  first  field  in  the  file  lists  the  countries  in  alphabetical  order.  For 
each  scenario  year,  a  “pro-U.S.”  factor  is  given  in  the  subsequent  fields. 

Anti-U.S.  sentiment  is  modeled  as  causing  delay  in  the  delivery  of  material 
supplies  to  the  United  States.  A  “1”  indicates  totally  pro-U.S.  sentiment  and  that 
no  portion  of  material  supply  from  that  country  is  subject  to  delay,  while  a  “0” 
indicates  totally  anti-U.S.  sentiment  and  that  all  material  supply  from  that  country 
is  subject  to  delay.  The  length  of  the  delay  is  determined  by  other  inputs. 
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The  Pro-U.S.  Factors  input  file  defines  the  willingness  of  a  country  to  produce  to  its  stated  industrial  capability  or  capacity  in  a 
given  year.  Note  that  these  values  can  change  from  year  to  year  to  reflect  ongoing  conditions  within  a  given  country 
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IDA  Input  of  Country  War  Damage  Factors 

The  file  smpwarsp.txt  contains  the  war  damage  factors  for  countries  that  supply 
S&CM.  In  this  file,  the  figure  0.75  indicates  that  the  supplier  has  lost  25%  of 
supply  capability  to  war  damage.  This  information  is  used  in  the  supply 
calculations. 

The  first  field  is  a  list  of  the  countries  in  alphabetical  order.  The  first  row  must 
have  the  years  in  chronological  order.  Each  data  cell  represents  the  war 
damage  factor  a  country  in  a  specified  year. 

The  screenshot  below  indicates  no  war  damage  for  any  country. 
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This  information  is  calculated  by  IDA  based  on  conflict  parameters  specified  by  the  Office  of  the  Undersecretary  of  Defense  for 
Policy  (OUSD(P))  in  classified  Defense  Planning  Scenarios.  This  factor  can  be  used  to  specify  the  percentage  of  capacity  that  is  avail¬ 
able  on  a  year-by-year  basis  for  each  country  during  the  analysis  period  being  considered. 
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IDA  Input  of  Country  Shipping  Losses 

The  file  smpsslsp.txt  contains  the  shipping  loss  factors  for  countries  that  supply 
S&CM.  In  this  file,  the  figure  0.5  indicates  that  50%  of  the  country’s  supply  to  the 
United  States  is  lost  in  transit  due  to  enemy  attack,  and  therefore  does  not 
arrive  in  the  United  States.  A  value  of  0.8  would  mean  that  20%  is  lost  in  transit. 
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This  information  is  supplied  by  OUSD(P)  based  on  classified  Defense  Planning  Scenarios.  This  factor  indicates  the  loss  of  sup¬ 
plies  due  to  degradation  in  shipping  of  S&CM. 
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IDA  Input  of  U.S.  Market  Share  Inputs 

There  are  two  methods  of  implementing  market  share  in  SSM.  The  user  can 
calculate  market  share  outside  of  SSM  and  enter  values  into  a  Market  Share 
input  file  (smpmrkts),  or  the  user  can  enter  multiple  input  files  that  SSM  uses  to 
calculate  market  share  within  the  model.  Since  the  first  method  is  preferred,  the 
user  should  use  the  Market  Share  input  file.  However,  due  to  legacy  code  issues, 
the  user  still  must  enter  the  extra  input  files  (Foreign  Demanders,  Demand  Factor 
Political  Reliability,  and  Demand  Factor  War  Damage).  These  extra  input  files 
should  be  constructed  as  “null  files”  (i.e.,  with  the  correct  header  names  but  with 
no  entries).  See  the  notes  to  this  slide  for  details. 

In  the  market  share  file  in  the  screenshot  below,  the  first  field  is  the  material,  and 
the  subsequent  entries  are  U.S.  market  shares  of  that  material  in  the  given  year. 
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In  the  context  of  the  SSM,  the  tenn  “U.S.  market  share”  refers  to  the  fraction  of  foreign  supply  (of  a  given  material)  that  the 
United  States  can  obtain.  It  operates  in  addition  to  the  other  decrement  factors.  The  U.S.  market  share  can  be  calculated  within  SSM. 
In  practice,  it  typically  is  calculated  outside  of  SSM  and  entered  via  this  input  file.  The  procedure  for  calculating  U.S.  market  share  is 
to  use  three  different  algorithms,  choose  the  highest  result  as  the  initial  peacetime  market  share,  apply  decrement  factors,  and  use  the 
result  as  the  U.S.  foreign  market  share  input  file  for  SSM. 

The  three  market  share  calculation  methods  are  the  gross  domestic  product  (GDP)  method  (in  which  U.S.  market  share  of  a  par¬ 
ticular  material  is  equal  to  the  ratio  of  the  U.S.  GDP  to  the  sum  of  the  GDPs  of  all  countries — including  the  United  States — that 
demand  the  material),  the  production  method  (in  which  U.S.  market  share  for  a  given  material  is  equal  to  the  ratio  of  U.S.  imports  to 
foreign  production),  and  the  Peacetime  Equilibrium  Adjustment  Process  (which  is  too  lengthy  to  describe  here  but  can  be  explained 
upon  request). 

Whatever  market  share  calculation  method  produces  the  highest  estimate  is  chosen  as  the  initial  peacetime  market  share.  Due  to 
legacy  code  issues,  three  extra  input  files  must  be  applied  to  transform  the  initial  peacetime  market  share  into  a  share  appropriate  for 
the  conflict  scenario: 

•  Foreign  Demanders.  This  input  file  lists  the  countries  that  demand  S&CM  and,  hence,  are  market  competitors  of  the  United 
States. 

•  Demand  Factor  Political  Reliability.  This  input  file  refers  to  countries  that  are  not  part  of  the  U.S.  trading  bloc  and,  hence, 
should  not  be  considered  market  competitors.  These  countries  (typically  coded  as  U.S.  government-listed  state  sponsors  of 
terror)  are  omitted  from  the  aforementioned  market  share  calculations. 

•  Demand  Factor  War  Damage.  This  input  file  refers  to  the  decrease  in  foreign  demand  for  a  particular  material  resulting 
from  war  damage  to  production  facilities  (e.g.,  a  bombed-out  steel  factory  will  demand  less  iron)  and  is  calculated  by  IDA  on 
the  basis  of  classified  Defense  Planning  Scenarios. 

The  SSM  has  input  files  for  these  quantities  (legacy  code);  however,  in  practice,  they  are  used  in  an  offline  (Excel)  calculation,  and 
dummy  null  files  are  input  to  the  SSM.  The  values  resulting  after  these  decrements  are  used  as  the  market  share  inputs.  Note  that  mar¬ 
ket  share  varies  by  material  and  year  but  not  by  country. 
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IDA  Input  of  GDPs 

The  GDP  input  file  (smpgdpdm)  shows  GDP  figures  for  each  country  that 
demands  S&CM.  All  figures  are  in  billions  of  dollars.  This  information  is  used  to 
model  the  length  of  delay  in  the  delivery  of  supplies  to  the  United  States  as  a 
result  of  anti-U.S.  sentiment. 
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CIA  World  Factbook  estimates  are  used  for  country  GDPs.  In  SSM,  GDP  is  a  proxy  for  national  strength.  A  stronger  country 
likely  can  withhold  material  supplies  from  the  United  States  for  a  longer  period  of  time.  As  such,  the  ratio  of  country  GDP  vs.  U.S. 
GDP  is  used  to  calculate  the  length  of  delay.  Note  that  the  portion  of  a  country’s  material  supply  production  that  is  subject  to  delay  is 
detennined  by  that  country’s  Pro-U.S.  Factor,  as  explained  on  Slide  27. 

Note  that  all  values  in  the  example  are  set  to  one.  This  is  done  in  order  to  create  a  constant  delay  for  all  countries  (e.g.,  six 
months).  Delay  time  also  is  affected  by  the  cut-off  ratio  (found  in  the  Case  File)  and  the  length  of  the  scenario. 
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U.S.  MATERIAL  DEMAND  INPUT  FILES 
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Material  demand  must  be  input  in  order  for  SSM  to  compare  it  to  available  supply  and  then  compute  surpluses  and/or  shortfalls. 
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IDA  Input  of  U.S.  Demand/Requirements  into  SSM 

The  file  smpusreq.txt  contains  U.S.  requirements  figures  for  each  material  for 
each  year  for  each  “tier”:  military  demands,  emergency  investment  demands, 
and  civilian  demands.  All  figures  are  in  the  units  that  are  specified  in  the  basic 
information  file.  Note  that  the  scenario  years  in  the  top  row  are  repeated  three 
times.  The  first  set  is  military  demands,  the  second  set  is  emergency  investment 
demands,  and  the  third  set  is  civilian  demands.  This  file  is  obtained  from  the 
demand  computation  calculation,  which  is  external  to  the  SSM.  The  first  field  is 
the  material  listed  in  alphabetical  order.  The  subsequent  columns  show  the  U.S. 
demands  by  year  and  tier. 
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U.S.  Requirements  refers  to  the  amount  of  materials  required  by  the  United  States — broken  down  by  material,  year,  and  tier 
(defense,  civilian,  and  emergency  investment).  In  this  context,  the  terms  demand  and  requirements  are  used  synonymously.  This  infor¬ 
mation  is  the  result  of  calculating  U.S.  industrial  base  production  requirements  via  the  Forces  Mobilization  Model  (FORCEMOB)  and 
calculating  the  materials  and  quantities  needed  to  support  said  production  via  the  use  of  material  consumption  ratios  (MCRs)  and  other 
material  consumption  information.  These  calculations  constitute  Steps  2-A  and  2-B  of  RAMF-SM. 
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6.  Output  Reports 


This  section  addresses  SSM  output  reports. 
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IDA  SSM  Output  Reports 

SSM  produces  a  wide  variety  of  output 
reports.  These  reports  are  generally 
self-explanatory  upon  use  and  will  not 
be  explicitly  examined  here. 

Most  output  reports  are  in  a  .rpt 
format,  which  will  open  in  either 
Notepad  or  Excel. 

Note:  The  report  “matsum,”  which 
aggregates  information  from  all  the 
other  output  reports,  is  somewhat 
buggy  and  should  not  be  relied  upon. 
Accurate  information  can  be  obtained 
from  the  individual  output  report  files. 
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Name 

Date  modified 

Type 

adjgnp.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  carrydwn.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2j  casedesc.rpt 

7/9/2014  2:17  PM 

RPT  File 

[jl]  debug. rpt 

7/9/2014  2:17  PM 

RPT  File 

forprodl.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  forprod2.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  forprod3.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  forsupl.rpt 

7/9/2014  2:17  PM 

RPT  File 

pi  forsup2.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  forsup3.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  goalsum.rpt 

7/9/2014  2:17  PM 

RPT  File 

|~2]  goalyear.rpt 

7/9/2014  2:17  PM 

RPT  File 

|  [2]  matsum. rpt 

7/9/2014  2:17  PM 

RPT  File 

[fi)  misscnt.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2*1  missmat.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  mktshare.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  nrelass.rpt 

7/9/2014  2:17  PM 

RPT  File 

(2j  relass.rpt 

7/9/2014  2:17  PM 

RPT  File 

[j  supdbg.txt 

7/9/2014  2:17  PM 

Text  Doci 

supdmd.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  totglyr.rpt 

7/9/2014  2:17  PM 

RPT  File 

pi  totgoall.rpt 

7/9/2014  2:17  PM 

RPT  File 

(2|  totgoal2.rpt 

7/9/2014  2:17  PM 

RPT  File 

Pl  totgoal3.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  trylll8.cas 

7/9/2014  2:17  PM 

CAS  File 

f  1  trylll8.log 

7/9/2014  2:17  PM 

Text  Doci 

usprodl.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  usprod2.rpt 

7/9/2014  2:17  PM 

RPT  File 

[2]  usprod3.rpt 

7/9/2014  2:17  PM 

RPT  File 
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For  each  SSM  case,  the  program  creates  a  subdirectory  under  the  output  directory  and  puts  the  output  files  for  that  case  in  that 
subdirectory.  The  subdirectory  name  is  the  same  as  the  case  name.  Most  of  the  SSM  output  reports  have  the  suffix  .rpt,  but  they  are 
tab-delimited  text  files  and  are  best  viewed  in  Excel.  These  output  reports  can  also  be  viewed  in  Notepad  and  are  generally  self- 
explanatory.  The  first  report  to  view  is  goalsum.rpt,  which  has  the  overall  shortfalls  by  material  and  tier  of  demand  (i.e.,  defense  short¬ 
falls  represent  unsatisfied  defense  demand,  civilian  shortfalls  represent  unsatisfied  civilian  demand,  and  so  forth).  The  file  goalyear.rpt 
has  shortfalls  by  material,  tier  of  demand,  and  scenario  year. 
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7.  User  Tips 


The  next  two  slides  outline  some  practical  concerns  and  tips  for  using  SSM. 
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IDA  SSM  User  Tips  and  Cautions  (1  of  2) 

SSM  prioritizes  user  control.  This  prioritization  grants  a  high  degree  of  analytical 
power  and  precision  but  incurs  a  cost  in  terms  of  possible  user  error.  The 
following  issues  should  be  kept  in  mind  when  running  SSM: 

•  Filename  and  directory 

-  SSM  searches  for  input  files  by  name  in  the  directory  specified  by  the  user  in  the  .sbf  file. 

If  the  two  are  incongruent  (e.g.,  the  .sbf  files  specify  C:\SSM  but  the  files  actually  are 
stored  in  C:\Users\JohnSmith\MyDocuments\SSM),  the  program  will  not  function  properly. 
The  same  applies  for  output  files. 

-  SSM  will  overwrite  preexisting  output  files  in  the  output  directory.  Remember  to  save  the 
results  of  a  particular  run  under  a  different  name  (e.g.,  change  matsum.rpt  to 
matsum_run23.rpt)  or  in  a  different  directory.  It  also  is  ideal  to  save  the  input  files  used  for 
a  particular  run  to  keep  track  of  what  parameters  were  specified. 

-  Filenames  and  pathnames  cannot  exceed  260  characters. 
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IDA  SSM  User  Tips  and  Cautions  (2  of  2) 

SSM  prioritizes  user  control.  This  prioritization  grants  a  high  degree  of 
analytical  power  and  precision  but  incurs  a  cost  in  terms  of  possible  user  error. 
The  following  issues  should  be  kept  in  mind  when  running  SSM: 

•  Data  inputs 

-  SSM  will  run  whatever  is  written  in  the  input  files.  It  is  important  to  double-check  all  input 
files  to  ensure  that  there  is  no  incongruity  between  what  parameter  values  you  want  to 
use  and  what  is  actually  written  in  the  input  file.  SSM  does  not  “know,”  for  example,  the 
correct  political  reliability  coding  for  a  particular  country;  therefore,  an  unidentified  error 
can  linger.  Tab-delimited  text  file  errors  are  easy  to  spot  in  MS  Excel. 

-  SSM  files  must  follow  correct  syntax  and  grammar.  A  misplaced  comma,  missing  tab 
delimitation,  and  so  forth  will  cause  SSM  to  generate  an  error  message. 

•  Debug  and  log 

-  SSM  automatically  generates  a  debug  file  and  a  log  file.  Both  files  are  valuable  resources 
if  SSM  does  not  run  properly  and  likely  will  point  you  to  the  file  causing  the  error. 
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8.  Student  Tutorial 


The  last  three  slides  posit  fictional  scenarios  for  the  SSM  trainee  to  simulate.  These  scenarios  are  intended  as  a  “hands-on” 
learning  opportunity  on  operation  of  SSM  so  that  the  trainee  will  achieve  a  better  understanding  of  the  relationship  between  its  inputs 
and  outputs. 
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IDA  Student  Exercise  Tutorial  1 

What  if  U.S.  combat  losses  and  munitions  expenditures  are  larger  than 
expected?  Let  us  say  that  overall  defense  outlays  will  be  10%  larger. 

•  This  larger  than  expected  expenditure  means  that  defense  regeneration 
needs  will  be  higher  than  anticipated,  thus  requiring  the  Department  of 
Defense  (DOD)  to  rebuild  more  weapons  platforms  and  replace  larger 
quantities  of  munitions.  This  new  requirement  increases  material 
demand  by  the  industrial  base. 

•  Simple  implementation 

-  Increase  the  defense  material  demands  across  the  board  by  10%  in  the  SSM 
US  Requirements  input  file.  Rerun  SSM  to  compute  the  new  material 
shortfalls. 

•  N.B.  This  scenario  ignores  the  macroeconomic  relationships  between 
production  and  industrial  sector  material  demand. 
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This  implementation  is  simple  and  not  totally  accurate  because  the  relationship  between  increased  defense  outlays,  industrial 
base  production,  and  material  demand  involves  non-linear  dependencies. 

In  this  implementation,  we  are  positing  that  a  10%  increase  in  defense  spending  results  in  exactly  10%  greater  defense  demand 
for  every  material  under  study.  In  reality,  several  complications  have  to  be  considered: 

•  Increased  defense  spending  also  affects  the  civilian  economy  (likely  increasing  civilian  material  requirements). 

•  The  manner  in  which  defense  spending  is  increased  has  a  powerful  effect  on  the  material  quantities  needed  to  support  this 
spending.  For  example,  the  material  requirements  of  increased  defense  spending  driven  by  regeneration  of  lost  weapons  plat¬ 
forms  and  munitions  depend  on  the  specific  material  requirements  of  the  weapons  to  be  regenerated  and  will  almost  certainly 
result  in  different  material  requirements  than,  for  instance,  increased  defense  spending  driven  by  military  health-care  and  per¬ 
sonnel  costs. 

A  more  accurate  examination  of  the  impact  of  increased  defense  spending  would  necessitate  rerunning  the  Interindustry  Large- 
scale  Integrated  and  Dynamic  Model  (ILIAD),  the  Long-tenn  Interindustry  Forecasting  Tool  (LIFT),  and  FORCEMOB  with  altered 
parameters  to  account  for  these  non-linear  dependencies,  as  detailed  on  the  next  slide. 
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IDA  Student  Exercise  Tutorial  la 

What  if  you  wanted  to  account  for  the  material/demand  differences  that 
were  suggested  previously? 

•  Practical  implementation 

-  Rerun  the  Forces  Mobilization  Model  (FORCEMOB)  with  the  higher  specific 
platform  losses  and  munitions  expenditures  to  obtain  more  accurate  material 
requirements. 

-  Enter  these  larger  and  more  accurate  defense  demands  into  the  SSM  US 
Requirements  input  file. 

-  Rerun  SSM. 

-  Compare  the  results  between  Exercises  1  and  la. 

•  If  the  additional  loss/expenditure  numbers  cause  greatly  increased 
spending  relative  to  the  Future  Years  Defense  Plan  (FYDP),  one  might 
actually  need  to  rerun  the  Long-term  Interindustry  Forecasting  Tool 
(LIFT)  and  the  Interindustry  Large-scale  Integrated  and  Dynamic  Model 
(ILIAD)  to  account  for  the  non-linear  dependencies  between  material 
demand  and  expenditures. 


81 


This  implementation  is  much  more  labor  intensive  but  accounts  better  for  the  non-linear  dependencies  between  defense  spending, 
industrial  production,  and  material  demand. 
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IDA  Student  Exercise  Tutorial  2 

What  if  the  United  States  and  a  major  supplier  of  critical  and  strategic 
materials  become  fast  friends? 

What  happens  to  material  shortfalls  when  available  supplies  of  foreign 
critical  and  strategic  materials  change  from  U  (unreliable)  to  R  (reliable) 
to  A  (assured)? 

•  Practical  implementation 

-  Make  a  series  of  SSM  runs  to  determine  the  impact  of  political  reliability 
codes  on  material  supply. 

-  Use  default  parameters  on  the  Case  File  and  Method  1  under  “default  supply 
parameters”  in  the  Case  File. 

-  Compare  the  results  between  all  U,  all  R,  and  all  A  country  reliability  settings. 

•  Can  foreign  supplies  be  used  to  meet  all  demand  requirements? 
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This  slide  illustrates  how  the  SSM  can  be  used  to  support  exploratory  analysis  of  the  impact  of  larger  political  trends  on  S&CM 
availability.  This  capability  is  particularly  useful  for  assessing  alternate  scenarios,  which  (per  the  Strategic  and  Critical  Materials 
Stockpiling  Act)  must  be  included  in  NDS  Requirements  Reports. 
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compact  disc 

Defense  Logistics  Agency 
Department  of  Defense 
Forces  Mobilization  Model 
Future  Y ears  Defense  Plan 
Gross  Domestic  Product 
Intelligence  Community 
Institute  for  Defense  Analyses 

Interindustry  Large-scale  Integrated  and  Dynamic  Model 

Interindustry  Forecasting  Project  at  the  University  of  Maryland 

Long-tenn  Interindustry  Forecasting  Tool 

material  consumption  ratio 

National  Defense  Stockpile 

Office  of  the  Secretary  of  Defense 

Office  of  the  Undersecretary  of  Defense  for  Policy 

Risk  Assessment  and  Mitigation  Framework  for  Strategic  Materials 

strategic  and  critical  materials 

subject  matter  expert 

Stockpile  Sizing  Module 

United  States 

U.S.  Geological  Survey 
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